The World of Computer Software

home *** CD-ROM | disk | FTP | other *** search

/ The World of Computer Software / The World of Computer Software.iso / shel47.zip / SHELL.DOC < prev next >

Wrap

Text File | 1993-01-07 | 24KB | 460 lines

======================================================================= | ***** *** *** *** ******* ******** | | ** ** ** ** ** *** ** ** ** ** | | ** ** ** ** *** *** ** ** ***** ** | | ***** ** ** *** **** ** ** ** ** | | ** ** ** ** *** ** ** ** ** ** | | ** ** *** *** *** ** ** | ======================================================================= _______ ____|__ | (R) --| | |------------------- | ____|__ | Association of | | |_| Shareware |__| o | Professionals -----| | |--------------------- |___|___| MEMBER # D O S U T I L I T I E S # =========================================== |*******************************************| | RO-SOFT SYSTEMS (C) 1989-93 | |===========================================| | DOS SHELL Ver 4.7 BY Robert Ossowski | |*******************************************| =========================================== * MAKE YOUR COMPUTING EASY * *********************************************************************** | **** *** *** *** ** ** ****** ** ** | | ** ** ** ** ** ** ** ** ** ** ** ** ** | | ** ** ** ** *** *** ******* **** ** ** | | ** ** ** ** **** **** ******* **** ** ** | | ** ** ** ** ** ** ** ** ** ** ** ****** ****** | | **** *** *** *** ** ** ****** ****** ****** | | | | ** ** ******* ** ** ** ** *** | | *** *** ** *** ** ** ** ** ** | | ** * * ** ***** ** * ** ** ** *** | | ** ** ***** ** * ** ** ** **** | | ** ** ** ** *** ** ** ** ** | | ** ** ******* ** ** **** *** | *********************************************************************** =========================================== |*******************************************| | RO-SOFT SYSTEMS (C) 1989-93 | |===========================================| | DOS SHELL Ver 4.7 BY Robert Ossowski | |*******************************************| =========================================== * MAKE YOUR COMPUTING EASY * * SHELLC.COM & SHELL.COM * These routines allow running a DOS system without ever having to see the DOS prompt. All selections may be made by using the keyboard or the mouse buttons. Their memory usage is less than 1K Bytes, to launch any application. Features include : * Virus detection in all included utilities * Almost no memory overhead * Automatic screen layout of menus * Up to thirty-two entries per menu page * Menu line description up to sixty-five characters * Command string up to sixty-five characters * Use log may be generated or not as needed * A binary use log that cannot be edited * Password protection available on any menu line * Run DOS .BAT files * Formatted or direct edit menu changing and creation * No limit on number of menu pages * Permanent screen color selection by user * Compact menu files * VIRUS DETECTION * Each Routine, when loaded by DOS, first locates the disk file from which it originated, then runs a checksum on that file. If the results do not match its stored value a message is dis- played indicating an integrity violation, and the routine terminates. * MEMORY MANAGEMENT * The SHELLC.COM routine is a very compact DOS execute function. When loaded, it first runs SHELL.COM, which is the main body of the menu system. This routine handles all the menu swap- ping and selection entry. When a command string is selected, it passes the string to SHELLC.COM and terminates, freeing up all memory that it occupied. When SHELLC completes execution of the commands given, it re-loads SHELL.COM. The memory overhead of SHELLC is about 1K Bytes. * SHELL MENUING SYSTEM BY RO-SOFT * * USE LOG * There are two types of log files available. A Ctrl-F10 will initiate a text log and an Alt-F10 will initiate a binary log file. The binary log is only legible by the internal shell functions and gives use report security for auditing purposes. The list and print functions of the shell handle both types. If initialized by the F10 function, the log receives entries when the SHELL is loaded by DOS, when a command string is executed, when a command string is finished, and when the SHELL is terminated. The Command finished and SHELL terminate entries contain run-time calculations. This log will accumulate entries until it is deleted by using the Shift-F10 function. Example as follows : Thr-Jun-20 at 11:03:16AM Use log initialized 11:03:20AM Run C:\TASM\WORK\EDIT.EXE 01:21:48PM Run time 02:18:28 01:21:54PM Shell EXIT Run time 02:18:38 * MENU PAGES * Each menu page resides in a separate menu file with a name describing that page. The menu page consists of a menu title line and up to thirty-two, two line menu entries. Each menu page must contain at least one entry that loads a new menu, giving a path through the system. There may be as many menu pages as you need. * AUTOMATIC LAYOUT * The menu listing screen layout is handled auto- matically by the shell. With a number of entries up to six, they are set up in a single column. Over six will be aligned in two columns if none of the descriptions are longer than thirty-two characters. The following limitations apply : * A maximum of thirty-two entries per menu, when maximum description length does not exceed thirty-two characters. * A maximum of sixteen entries per menu page, if any description is longer than thirty-two characters. * MENU TITLE LINE * This is the first entry in the menu file. It will be displayed above the menu list on the screen. You may put anything on this line you wish. * MENU ENTRY * Each menu entry consists of two lines. The first line is the text to be displayed describing this menu selection. The system will fill the first four characters of a description with a selection letter (i.e."«A» "), using letters A thru Z. The description lines may be of variable length, but no longer than seventy-six characters. They are any meaningful description of the command to follow. The second menu entry line contains the command string. Both lines of each entry must be filled. No separators or blank lines are allowed. * SHELL MENUING SYSTEM BY RO-SOFT * * COMMAND STRING * This is the second line of a menu entry. It is the command, or command string, associated with the previous descriptive entry. The command line may contain one or several valid DOS commands, each separated by a comma. A password may also be entered here. The password must be at the end of the command string and must begin with a "#" character, which is not a part of the password. The max- imum length for this entry, including any password, is set at sixty- five characters. These command strings are read in by the SHELL to execute a function (i.e. C:,CD\WP5,WP.EXE). This command string tells DOS to set drive C: current, change to directory WP5, load and execute a file named WP.EXE (i.e. Load and run Word Perfect). If any command options are needed they may be added to the command WP, as in normal DOS command entry. Programs such as Word Perfect require that their directory be current to run so you must enter the set drive, and the change directory commands on the command line. For best results under all conditions always enter the routines full name and extent. * MENU SELECTION * The selection of any menu entry can be accomplished by using the keyboard or the mouse. The shell automatically assigns the letters "A" thru "Z" to the first twenty-six menu page entries. This allows selection of these entries simply by pressing the letter key associated with that entry. Keyboard or mouse selection may also be made by moving the highlight bar to a desired entry, then pressing the "Enter" key or left mouse button. * DEFAULT MENU * In the event of a menu read error, the SHELL reverts to a built-in default menu. The header line of this menu informs you that you should check the menu file for damage or incorrect entry. * PASS WORD PROTECTION * A password beginning with a "#" character may be added at the end of any command string. This pass word may be any keyboard characters, up to twenty-five long. It will be displayed on screen only as you are initially entering it. All line edit func- tions, except Back-Space, are disabled while you are entering a pass- word. Once entered and stored, its display will not be recognizable. A password entry prompt can be by-passed by entering the following sequence: ".#.#.#.#.#.#". If no passwords have been entered, you will never see the password input prompt. Entry format is as follows : * "C:,CD\WP5,WP.EXE#MyPass" * This command string contains three valid DOS commands and a password. Command #1 : "C:" : Set drive C to be current drive Command #2 : "CD\WP5" : Change directory to C:\WP5 Command #3 : "WP.EXE" : Run program WP.EXE Password : "MyPass" : Case sensitive password to execute * SHELL MENUING SYSTEM BY RO-SOFT * * LOAD NEW MENU * This is an internal shell function, "GETMENU", that loads the menu entered as its command option. All menus must contain at least one entry with this command, "GETMENU MENUNAME", where MENU- NAME is the name of the menu to be loaded. Menu names are a maximum length of eight characters as defined by DOS for a filename. Any menu may contain a menu line to load any other menu available on the system. * MENU HELP FUNCTION * The file SHELLHLP.DAT contains data describing initialized menu selections. This file should be put in the same dir- ectory in which SHELL.COM and SHELLC.COM reside. Pressing function key "F1", or the right mouse button calls up information from this file pertaining to the currently highlighted menu entry. * SETCOLOR * This is an internal function of the SHELL that allows you to set your desired screen, border, and highlight colors. It displays a palette of sixteen colors, 0 thru 15. You may select to change the character color (foreground) or the background color (screen). As the selection is made, the new color is displayed only on the select line until you select "Esc". Then the new color will then be displayed on whole screen and you are returned to the color select menu. Once you get the desired colors and exit, this new color scheme is stored in the code segment on disk so that the next time the SHELL is loaded it will display in these colors. Be aware that changing the color palettes will affect other program screen display. The standard default palettes are zero for the low eight colors and fifteen for the high eight colors. When you EXIT the shell the system palettes are set to these standards. * Add or Change A Menu * These functions are normally handled by the routine "CHNGMENU.COM". This routine displays a list of the current system menus and prompts for a menu name entry. To create a new menu, just enter a name that is not on the list. The new menu file will be created and the first menu line will be initialized as an exit line. This line may be changed as you wish, but an exit line to another menu must be maintained for system navigation. To change a current menu, just enter its displayed name. It will be loaded and displayed in a formatted edit window. * This routine supplies the following editing support * * Left arrow * Go left one character * Right arrow * Go right one character * Up arrow * Go up one screen line * Down arrow * Go down one screen line * Home * Go to beginning of line * End * Go to end of current line * Insert * Toggle character insert/overWrite * Delete * Delete a character at cursor position * Alt-L * Insert a new two line menu entry * Alt-Y * Delete current two line menu entry * F10 * Store changed menu file * Esc * Exit and not store changes * SHELL MENUING SYSTEM BY RO-SOFT * * MENU.MEU * This is a master menu set up with selections for the pre-initialized system menu pages. As with any other menu, it may be changed as you wish. There may be as many master menu pages as you need. ===================================================================== | 11:21:32AM | | | | SHELL MENUING SYSTEM BY ROBERT OSSOWSKI | | | | | | <A> Get system utilities menu | | Get user applications menu | | <C> Get DOS utilities menu | | <D> Get game recreation menu | | <E> List shell use log | | <F> Print shell use log | | | | | | To select entry press <?> key, or move highlight and press "Enter"| ===================================================================== * CHNGMENU.COM * The following is the edit display that you would see upon selecting the change menu function for this menu. It is shifted right for printing. The selection letters (i.e. "<A> ") are auto- matically inserted by the shell when the menu is read in. Make or change entries for menu : MENU.MEU Menu Header: SHELL MENUING SYSTEM BY ROBERT OSSOWSKI Menu Line : Get system utilities menu Command : GETMENU SHELMENU Menu Line : Get user applications menu Command : GETMENU APPLMENU......................................... Menu Line : Get DOS utilities menu Command : GETMENU DOSMENU Menu Line : Get game recreation menu Command : GETMENU GAMEMENU Menu Line : List shell use log Command : LISTLOG Menu Line : Print shell use log Command : PRINTLOG Line Number 2 Press F10 to store / Esc to exit * SHELL MENUING SYSTEM BY RO-SOFT * * SYSTEM UTILITIES MENU * This menu, "SHELMENU.MEU", is set up to run the DOS utilities supplied in this package. They are a set of greatly improved help utilities to enhance your computer usage. You may add entries here if you wish. The first entry will be highlighted for your selection by the "Enter" key or by the left mouse button. The highlight may be moved by using the arrow keys or the mouse movement. ======================================================================= | Wed-Jan-22 | | DOS UTILITIES BY ROBERT OSSOWSKI | | | | <A> Exit system utilities <M> List dirs / execute files | | File management <N> Scan disk for read errors | | <C> Edit a text file <O> Run disk optimizer | | <D> Locate a disk file Load DOS function key command| | <E> List user memory map <Q> Load DOS help utility | | <F> Create/Change a menu <R> Load pop-up calculator | | <G> List/Print directory <S> Load on screen clock | | <H> Sort disk directories <T> Load palette change | | Recover a deleted file Load pop-up calendar | | <J> Repeat command in all dirs <V> Set new screen color | | <K> List/Print directory tree <W> Go to DOS | | <L> Get equip configuration <X> Exit shell | | | | To select entry press <?> key, or move highlight and press "Enter" | ======================================================================= * SHLMENU.MEU * The following is a listing of this menu file with each two line entry on one line. Description Command String =============================== ============== Exit system utilities * GETMENU MENU File management * FILMAN.EXE Edit a text file * EDIT.EXE Locate a disk file * WHERE.COM List user memory map * MEMMAP.COM Create/Change a menu * CHNGMENU.COM List/Print directory * DDIR.COM Sort disk directories * SORTDIR.COM Recover a deleted file * UNDELETE.COM Repeat command in all dirs * REPTCOMM.COM List/Print directory tree * TREE.COM Get equip configuration * EQUIP.COM Load pop-up dir/list files * POPDIR.COM Scan disk for read errors * DISKSCAN.COM Run disk optimizer * DEFRAG.COM Load DOS function key command * DOSCOMM.COM Load DOS help utility * DOSHELP.COM Load pop-up calculator * CALC.COM Load on screen clock * SCRNCLK.COM Load palette change * PALETTE.COM Load pop-up calendar * POPCAL.COM Set new screen color * GETMENU COLRMENU Go to DOS * DOSC Exit shell * EXIT * SHELL MENUING SYSTEM BY RO-SOFT * * DOS UTILITY MENU * This menu is set up to run some of the DOS util- ities. The external DOS commands CHKDSK, FORMAT, & DISKCOPY, must be accessible through the DOS search path in order to function. There is no mouse support while running these commands. ====================================================================== | 11:21:34AM | | DOS UTILITIES DEMO By R. Ossowski | | | | | | <A> Exit DOS utilities <E> Set the system time | | Copy a floppy disk <F> Set the system date | | <C> Format a floppy disk <G> Go to DOS | | <D> Scan a disk for errors <H> Exit shell | | | | | | | | To select entry press <?> key or move highlight and press "Enter" | ====================================================================== Description Command String ============================ ============== Exit DOS utilities * GETMENU MENU Copy a floppy disk * GETMENU COPYMENU Format a floppy disk * GETMENU FORMMENU Scan a disk for errors * CHKDSK Set the system time * TIME Set the system date * DATE Go to DOS * DOSC Exit shell * EXIT * User Applications Menu * This menu is initialized for you to enter your system applications programs to be run from the shell. Choose the change a menu option and customize this menu to your liking. Remember to leave the exit option on this menu so you can return to the system. It contains only one selection that was entered to run WordPerfect on my system with the command string ( C:,CD\WP5,WP ). This command string tells DOS to set Drive C: to be the current default drive, go to directory \WP5, load and execute a file named WP (i.e. Load and run Word Perfect). If any options are needed, they may be added to the command WP as in normal DOS command entry with space separator.